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-- 3D Groove Xtra --
-- MAIN FUNCTIONS --
* InitGroove string SerialNumber --launch engine
* StepGroove -- Step into engine Loop
* UpdateGroove -- Update rendeing window
* ExitGroove -- Shut down engine (recommended before quitting application)
* RestartGroove -- Restarts engine without resetting the engine's prefs and settings
-- WORLD FUNCTIONS --
* LoadWorld string filename --Open GRV file and load default scene file
-- RENDERING SETUP (called before InitGroove) --
* SetRenderMode int n --Set software/hardware rendering device : 0=Software: 'Double Buffer' (default), 1=Software: 'Single Buffer', 2=3Dfx Glide, 3=Direct3D, 4=OpenGL
* RenderToScreen int ScreenWidth, int ScreenHeight --Attempts to set screen size to (ScreenWidth,ScreenHeight) and render to full screen
* RenderToWindow string WindowTitle,int x, int y, int Width, int Height --Creates and renders into new OS window 'WindowTitle' at window rect(x,y,x+Width,y+Height)
* RenderToStage int Zoom --Draws into entire stage or browser window with offscreen clipping (if zoom=1)
* RenderToTexture int TextureID --Renders scene into 16-bit texture 'TextureID'
-- RENDERING PROPERTIES (can be dyanimcly set)--
* SetRenderWindow int x, int y, int xx, int yy --Set coordinates for rendering window (realtive to top-left of the current graphics contect (usually the screen))
* ClearRenderWindow --clear drawing window
* SetZbuffer int n --Z-buffer mode: on (1) or off (0)
* SetInterlace int n --Use interlacing when drawing to screen: on (1) or off (0)
* SetLineDouble int n --Use line doubling when drawing to screen: on (1) or off (0)
* SetAntiAlias int n --Turn Anti-Aliasing on (1) or off (0)
* SetMipMapping int n --Turn MipMapping on (1) or off (0) (should be called before loading textures or sprites)
* SetPerspective int n --Set camera focal perspective (default=60 degrees)
-- NAVIGATION COMMANDS --
* SetNavigation int mode --Set navigation mode: -1=none, 0=fly (default), 1=hover, 2=walk (no looking up) 
* SetAvatar int ObjectID --Selects avatar object for 3rd person navigation
* SetControl int device, int n --Set navigation control using mouse (0) or keyboard (1) to on/off 
-- ASSET CREATION COMMANDS  --
* NewTexture int Width, int Height, int Depth -- Creates a new texture map with dimensions (Width, Height...scales up to power of 2 value, i.e. 64,128,256,512 or 1024) at BitDepth 'Depth' (8,16 or 32 RGBA) and returns the new texture's ID
* NewSprite int Width, int Height, int Depth -- Creates a new sptite/overlay texture map with dimensions (Width, Height up to 1024x512 in software, 1024x1024 in hardware) at BitDepth 'Depth' (8,16 or 32 RGBA) and returns the new spite texture's ID
* SetTexturename int TextureID, string Texturename -- Sets the name of texture, overlay or sprite 'TextureID' to the string value in 'TextureName'
* ReleaseTexture int TextureID -- Releases the memory taken up by texture 'TextureID' (assuming the texture is not being used by the renderer)
* ReleaseAllShapes -- Releases the memory taken up by all loaded shapes
* ReleaseAllTextures -- Releases the memory taken up by all loaded textures, sprites and material definitions
-- ADD OBJECTS TO 3D WORLD --
* AddShape int index, any x, any y, any z -- Add Shape to World; returns shape's index number in world
* AddInstanceShape int index, any x, any y, any z -- Add Shape Reference to World; returns shape's index number in world
* AddSplitShapes int ExistingShapeObjectID -- splits existing shape Object into subshapes and adds them to the world. Returns number of shapes added to the world
* AddSprite int index, any x, any y, any z -- Add Sprite to World; returns sprite's index number in world
* AddPrimitive int type, int size, int density, int TextureID, any x, any y, any z -- Add primitive object to World (type:1=sphere, 2=cylinder, 3=cube, 4=grid)
* AddLight int type, any x, any y, any z -- Add Light to World at position (x,y,z) (type: 0=directional, 1=Spot Light, 2= Omni Positional); returns light's index number in world
* AddParticles int SpriteID, any x, any y, any z, int Type -- Add Particle System to World (0=custom, 1=smoke, 2=fire, 3=frost, 4=exhaust, 5=sparks); returns index number in world)
-- LINKING AND HEIRARCHY FUNCTIONS --
* LinkObject int ChildObject, int ParentObject, int PositionLink, int PivotLink --Links two objects together based on Position ( if PositionLink=1) or orientation ( if PivotLink=1)
* UnlinkObject int ChildObject --detatches child object from parent object
* GetObjectParent int ObjectID --Returns parent object (if any) of object 'ObjectID'
* GetObjectChildren int ObjectID --Returns list of children objects (if any) of object 'ObjectID'
* AttachObjectToPoly int ObjectID, int TargetObjectID, int TargetPoly, any Distance --Attaches object 'ObjectID' to polygon 'TragetPoly' of object 'TargetObjectID' at 'Distance' units from the polygon's center
-- 3D GROOVE PROPERTY LIST FUNCTIONS --
* GetWorldInfo --Returns list of world properties
* GetCameraInfo --Returns list of camera properties
* GetObjectInfo int ObjectIndex --Returns list of object properties for object 'ObjectIndex'
* GetAssetInfo string AssetLib, int AssetIndex --Returns list of asset properties for asset 'AssetIndex' in asset library 'AssetLib' (e.g. 'shape', 'texture', 'light', 'particles' etc.)
* SetWorldInfo list WorldData --Sets World properties to values in list 'WorldData'
* SetCameraInfo list CameraData --Sets Camera properties to values in list 'CameraData'
* SetObjectInfo int ObjectIndex, list ObjectData --Sets the properties of object 'ObjectIndex' to the values in list 'ObjectData'
* SetAssetInfo string AssetLib, int AssetIndex , list AssetData --Sets the properties of asset 'AssetIndex' of library 'AssetLib' to the values in list 'AssetData'
-- CAMERA FUNCTIONS --
* GetCamera --Get camera position and angle variables (sets globals: camerax,cameray,cameraz,viewx,viewy,viewz)
* RotateCamera any x, any y, any z --Set camera rotation
* MoveCamera any x, any y, any z --Set camera position to point (x,y,z)
* CameraLookAt any x, any y, any z --Point camera at position (x,y,z)
-- OBJECT SATE COMMANDS --
* DeleteObject int n --removes object in index 'n' from world 
* GetObject int ObjectID --Get object in index 'n' position, angle and visibility variables  (sets globals: objx,objy,objz,objrx,objry,objrz,objvis)
  			  --Also sets globals (objvectorx,objvectory,objvectorz,objspinx,objspiny,objspinz,objspeed,objtype,objasset,objactive,objpath,objindex)
			  --and objradius, objpolys, objdots, objbfculling, objgroup)
* GetObjectProp int ObjectID, int PropertyIndex --Returns a single property value for the object (fastest method to do this from Lingo)
			  --Propvalues 1-43: x,y,z,rotx,roty,rotz,visible,
* GetObjectMatrix int ObjectID, int Index1, int Index2 --Returns value in [index1][index2] of Object ObjectID's 3x3 Transformation Matrix 
* SetObjectMatrix int ObjectID, int Index1, int Index2, any MatrixValue --Sets value in [index1][index2] of Object ObjectID's 3x3 Transformation Matrix 
* -- OBJECT FUNCTIONS --
* RotateObject int ObjectID, any x, any y, any z --Set object's orientation (yaw, pitch, roll) to angles (x,y,z) 
* MoveObject int ObjectID, any x, any y, any z --Move object's position to point (x,y,z)
* ScaleObject int ObjectID, any x, any y, any z --Scale object dimensions to x,y and z percent
* TurnObject int ObjectID, any x, any y, any z --Shift object's absolute rotation around each axis by x, y and z degrees
* TiltObject int ObjectID, any x, any y, any z --Shift object's relative orientation by x, y and z degrees
* ShiftObject int ObjectID, any x, any y, any z --Shift object's position by x, y and z units
* SlideObject int ObjectID, any AngleH, any AngleV, any Distance --Slide object along slopes angleH and angleV by 'distance' units
* SpinObject int ObjectID, any x, any y, any z --Spin object continuously by x,y and z degrees
* AlignObject int ObjectID1, int ObjectID2, any x, any y, any z --Aligns object 1 with object 2 with realtive position offset (x,y,z)
* PushObject int ObjectID, any Distance --Pushes object along current direction by 'Distance' units
* PullObject int ObjectID, any x, any y, any z, any Distance --Pulls an object towards point(x,y,z) by 'Distance' units
* OrbitObject int ObjectID, int TargetID, any AngleX, any AngleY, any Distance --Set ObjectID orbit around TargetID at Radius 'distance' and angles AngleX and AngleY
* OffsetObject int ObjectID, any x, any y, any z --Shift's an object's anchor point by x,y and z units
* CenterObject int ObjectID --Automaticaly centers an object's anchor point
* RestoreObject int ObjectID --Restores an object's properties to its asset's original values
* ReplaceObject int ObjectID --Targets an an  index 'ObjectID' as the object index slot that will be used in the next 'add' command (i.e. addshape,addsprite, etc.)
* SwapObject int ObjectID1, int ObjectID2 --Swaps an object's shape data with that of a different object
* ObjectLookAt int ObjectID, any x, any y, any z --Point object to position (x,y,z)
* SetObjectFocus int ObjectID, int Target --Forces object 'ObjectID' to always point at object 'Target' ObjectID or to maintain focal angle 'Target' (TargetID: -1= no object, -2=last ObjectLookAt' target, -3=point object in current vector direction
-- OBJECT PROPERTIES --
* SetObjectAnchor int ObjectID, any x, any y, any z --Sets an object's anchor point relative to its center
* SetObjectVisible int ObjectID, int n --Set object visibility (1=visible 0=invisible)
* SetObjectBFCulling int ObjectID, int n --Set object back face culling (1=draw only the front face of the object's polygons; 0=draw both sides of the object's polygon)
* SetObjectSize int ObjectID, any width, any height, any depth --Resize object into bounding box with dimensions 'width', 'height' and 'depth'
* SetObjectDepth int ObjectID, int DepthValue --Forces an object's depth of field value to 'DepthValue', allowing objects to be artifially moved closer of further in the field of view (depth=-1 resets unlocks the forced depth of field value; depth=-2, when used after a previous setobjectdepth command, offsets the polygons rather than forces their position)
* SetObjectLock int ObjectID, int x, int y, int z --Constrains object's x, y and z position (if Lock=1), rotation (if Lock=2) or both (if Lock=3) along each axis
* SetObjectShape int ObjectID, int ShapeLibIndex --Set object geometry to model stored in 'ShapeLibIndex'
* SetObjectSprite int ObjectID, int spritenumber --Set object 'ObjectID' to sprite bitmap 'spritenumber' ID
* SetObjectTexture int ObjectID, int texture --Set object texture ID
* SetObjectMaterial int ObjectID, int material --Set object material ID
* SetObjectColor int ObjectID, int Red, int Green, int Blue --Sets the RGB color value of an object 
* SetObjectBlend int ObjectID, any BlendPercent --Sets the Alpha blend percent value of an object (from 0-100%) 
* SetObjectOverlay int ObjectID, int OverlayID, int Offsetleft, int Offsettop, int Offsetright, int Offsetbottom, int mapmode -- Map overlay 'OverlayID' to the 2drect of Oject 'ObjectID' (map: 0: scale percent rect, 1: normal rect, 2: center point, 3: corner snap point)
* SetObjectWireFrame int ObjectID, int n --Render object 'ObjectID' in wireframe if n=1
* SetObjectIntensity int ObjectID, int Intensity --Sets amplitude value of an object (i.e. Sound Volume, Light Brightness, Particle System Birthrate, etc.)
* SetObjectUserData int ObjectID, int UserData --Assigns a user defines integer 'UserData' to Object 'ObjectID'; This can be retrieved using getobjectprop(objectid,45) or getobjectinfo(ObjectID)
-- OBJECT MOTION AND PHYSICS PROPERTIES --
* SetObjectActive int ObjectID, int n --Set automatic object motion (vectors and spins) to on (1) or off (0)
* SetObjectCollision int ObjectID, int CollisionFlag --Set automatic object collision detecion to on (1) or off (0)
* SetObjectGroup int ObjectID, int GroupID --Set object collision group
* SetObjectVector int ObjectID, any x, any y, any z --Set object vector motion values (x,y,z)
* SetObjectSpeed int ObjectID, any speed --Set object velocity to 'speed' (default=1.0) 
* SetObjectAcceleration int ObjectID, any speed, float vecx, float vecy, float vecz, float spinx, float spiny, float spinz  --Set object acceleration for velocuty (speed), vectors and spin (rotation(
* SetObjectRoll int ObjectID, int RollDegrees --Set object's automatic banking limit to 'RollDegrees' (will roll like a ball if 'RollDegrees'<0)
* SetObjectGravity int ObjectID, float grav --Set object's local gravity to value 'grav' (default=0.0) 
* SetObjectElasticity int ObjectID, float BounceValue --Set object's elasticity to 'BounceValue' (default=1.0) 
* SetObjectFriction int ObjectID, float friction --Set object's friction coefficient to 'friction' (default=0.0) 
* SetObjectPhysics int ObjectID, int PhysicsModel --Set object's physical behavior to type 'PhysicsModel' (default=0) 
-- OBJECT ANIMATION FUNCTIONS (Used with Multi-Frame Sprite and Shape Objects)--
* SetObjectAnimation int ObjectID, any PlaySpeed, any StartFrame, any EndFrame, any Loop --Set object's animation properties
* SetObjectFrame int ObjectID, any Frame --Set ObjectID's current frame index to value 'Frame' 
* SetSubObjectFrame int ObjectID, int SubObjectID, any Frame --Set ObjectID's current frame index to value 'Frame' 
* SetObjectKeyFrame int ObjectID, int FrameNumber, any X, any Y, any Z, any RotX, any RotY, any RotZ, any ScaleX, any ScaleY, any ScaleZ --sets current keyframe to X, Y and Z position, rotation and scale value and frame 'FrameNumber'
* GetObjectKeyFrame int ObjectID -- Returns X,Y and Z position, orientation and scale data in a linear list for ObjectID's current keyframe (if ObjectID=-1 then the most collision structure is returned)
* SubObject int ObjectID, int SubObjectID -- Returns temporary ObjectID of a shape's subobject so that it can be used in position, rotation and scale functions
-- OBJECT PATH FUNCTIONS --
* GetPathData int PathID, any PathIndex -- Returns linear list of X, Y and Z values of the position and orientation of path 'PathID' at frame index 'PathIndex'
* SetPathData int PathID, int PathIndex, any X, any Y, any Z, any Rotx, any Roty, any Rotz -- Sets the position and orientation values of the path keyframe 'PathIndex' of path 'PathID'
* SetObjectPath int ObjectID, int PathID --Moves Object along pre-recorded path 'PathID'
* SetObjectPathLoop int ObjectID, int Loop -- Sets the looping of an object's path (0=none, 1=loop, -1=loop back and forth
* SetObjectPathIndex int ObjectID, any Pathindex --Sets frame of object's current path to 'pathindex'
* SetObjectPathPlay  int ObjectID, any PlaySpeed --Sets the playspeed (i.e. 'playspeed=2' fast forwards the animation at 200% normal speed)
* SetObjectPathOffset  int ObjectID, any x, any y, any z, any Rotx, any Roty, any Rotz --Sets the offset coordinates of an object's path
* RecordObjectPath int ObjectID, int keyframespace, int framecount --Records path of object 'ObjectID' to path 'PathID' (returned) with number of frames 'framecount'
* BlendObjectPath int ObjectID, int TargetPathID, any TargetPathIndex, any BlendPercent --Blends the current position of object 'ObjectID'  with that of 'TargetPathIndex' in path 'TargetPath'; BlendPercent (0-100) controls the influence of the target path over ObjectID's new position
* FindPointinPath any X, any Y, any Z, int TargetPathID --Returns the index in path 'TargetPathID' nearest point (X, Y, Z); if TargetPath=0, then the most suitable path is located; result value is a list in form [TargetPathID, TargetPathIndex, PathX, PathY, PathZ]
-- OBJECT FX COMMANDS --
* HighLightObject int ObjectID, int n --Highlight object with flashing effect when n=1, restore to normal when n=0
* ExplodeObject int ObjectID --Explode polygonal object
* MorphObject int ObjectID, any SourceShapeID, any DestShapeID, any MorphPercent --Morph object 'ObjectID' to MorphPercent value between source and dest shapes
* SkewObject int ObjectID, any x, any y, any z --Skews an object by x, y and z percentage values
* TwistObject int ObjectID, any x, any y, any z --Twist's object's shape along each axis by x, y and z degrees
* BendObject int ObjectID, any x, any y, any z --Bend an object's shape along its anchorpoint by x, y and z degrees
* RippleObject int ObjectID, any x, any y, any z --Creates a ripple through object's mesh with frequencies (x,y and z) along each axis
* MeltObject int ObjectID, any percent --Melts an object's polygon mesh by percentage 'percent'
   -- GRAPHIC OVERLAY AND MASK FUNCTIONS -- 
* OverlayText string TextString, int X, int Y, int TextWidth, int TextHeight --overlay terminal text string over rendering screen at position (x,y) in a box with width 'TextWidth' and height 'TextHeigh'
-- BROWSER MOVIE FUNCTIONS --
* LoadBrowser string URL, int Width, int Height --loads a web browser playback renderer (using dimensions Width x Height) into a groove movie instance (returns a MovieID). The texture that the browser renders into MUST be the same width and height as the browser instance
-- STREAMING MOVIE FUNCTIONS (Vector and Digital Video) --
* LoadMovie string MovieFileName-- Loads a Movie from a file or URL and returns the new MoveID (and loads movie into memory before playing if Preload=1)
* GetMovieDownloadPercent int MovieID -- Returns the precentage of movie 'MovieID' that has been downloaded to disk
* SetMoviePreload int MovieID, int PreloadPercent -- Forces a movie to load 'PreloadPercent' into RAM before playback
* SetMovieTexture int MovieID, int TextureID -- Sets texture 'TextureID' as the image that movie 'MovieID' will render into
* SetMovieFile int MovieID, string MovieFileName -- Loads a new movie file (from FilePathName or URL) into the existing 'MovieID' slot
* SetMovieTime int MovieID, int Time -- Sets the current playback time of movie 'MovieID' to value 'Time' (measured in 1/60ths of a second)
* SetMovieDrame int MovieID, int FrameNumber -- Sets movie 'MovieID' to numbered keyframe 'FrameNumber'
* SetMovieSize int MovieID, int Width, int Height -- Sets the width and height of movie 'MovieID' before it is rendered into a texture
* SetMovieVolume int MovieID, int Volume -- Sets the volume of movie 'MovieID' to value 'Volume' (between values 0-255)
* SendMovieEvent int MovieID, int Event, int MouseClickX, int MouseClickY -- Sends move 'MovieID' a mouseclick event (MouseUp when Event=0, MouseDown when Event=1) at coordinates (MouseClickX,MouseClickY)
* PlayMovie int MovieID, any MovieRate, int Loop -- Sets playback state of movie 'MovieID' at MovieRate (0=stop, 1=normal, 2=FastForward, -1=Reverse); if Loop=1, then the movie will loop back to the beginning when the end is reached
* CloseMovie int MovieID -- Closes the movie instance of 'MovieID' (However SetMovieFile can still be called at a later point to load a new movie into movie 'MovieID')
* ReleaseMovie int MovieID -- Releases the movie instance of 'MovieID' from memory
-- STREAMING ANIMATION  COMMANDS (uncompressed 8-bit files)--
* LoadAnimationStream string filename, int preload --opens movie 'filename' for streaming, returns MovieID (if preload=1, then the whole movie is loaded into RAM)
* CloseAnimationStream int MovieID --Closes Movie stream in index 'MovieID' and disposes of all memory related to the movie
* SetAnimationStreamFrame int TextureID, int MovieID, int MovieFrame, int BlitMode --replaces texture in TextureID with frame 'MovieFrame' from movie 'movieID' (Blitmode 0: Solid, 1: Transparent, 2: Luminosity, 3: Chroma, 4: Darken, 5: Greenscreen, 6: Bluescreen
-- TEXTURE ATTRIBUTE FUNCTIONS --
* SetTextureBumpMap int TextureID, int BumpMapTextureID -- Assigns a bump map (with Texture ID BumpMapTextureID) to texture 'TextureID'
* SetTextureZPixelMap int TextureID, int ZPixelTextureID -- Sets Z-Pixel map (with Texture ID 'ZPixelTextureID') to texture 'TextureID'
* SetTextureAlpha int TextureID, int AlphaMode, int AlphaBlend --Sets Alpha Blend FX mode for texture (blend sets global alpha opacity value for texture, between 0-255)
* SetTextureBilinear int TextureID, int BilinearFilterMode --Sets Bilinear Filtering mode (on/off) for texture 'TextureID'
* SwapObjectTexture int ObjectID, int TextureID1, int TextureID2 --Swaps TextureID1 with TextureID2 in Object 'ObjectID
* SwapWorldTexture int TextureID1, int TextureID2 --Swaps TextureID1 with TextureID2 throughout all objects in the 3D world
* ScrollObjectTexture int ObjectID, int TextureID, int h, int v --Scrolls all texture 'TextureID' in object 'ObjectID' horizontally and vertically by h and v mapping units
-- TEXTURE/MATERIAL MAPPING FUNCTIONS --
* ReplaceTexture int TextureID, string filename --Replaces texture 'TextureID' with bitmap file 'filename'
* ReplaceMaterial int MaterialID, int red, int green, int blue, int alpha, int emission, int  ambient, int diffuse, int specular, int shininess  --Sets material properties with color (red, green, blue, alpha) and light properties: emission, ambient, diffuse, specular,  shininess
* GetMaterialColor int MaterialID, int MatComponent --Returns RGB and alpha values of material 'MaterialID'  (MatComponent 1:emission, 2:ambient, 3:diffuse, 4:specular)
* SetMaterialColor int MaterialID, int MatComponent, int red, int green, int blue, int alpha --Set RGB and alpha values of material component (MatComponent 1:emission, 2:ambient, 3:diffuse, 4:specular)
* SetMaterialEnvMap int MaterialID, int EnvMapMode, int TexID --Attaches Environment Map Texture to material definition
* WrapTextureSpherical int ObjectID, int HorizontalTiles, int VerticalTiles, int OffsetX, int OffsetY --Wraps texture as sphere over shape object 'ObjectID'
* WrapTextureDirectional int ObjectID, int HorizontalTiles, int VerticalTiles, int OffsetX, int OffsetY --Wraps texture as directional plane over shape object 'ObjectID'
-- SHAPE UTILITIES --
* ReduceShapePolys int ObjectID , int ThresholdAngle --Merges polygons with less then 'ThresholdAngle' degrees between them
* TesselateShape int ObjectID --Triangulates shape of object ObjectID
* SmoothShape int ObjectID, int n --Turns smoothing on (n=1) or off (n=0) for shape of object ObjectID 
-- LIGHT FUNCTIONS --
* SetWorldLight int percent --sets ambient world light brightness as pecent of maximum (default=90%)
--  SetLight Values: (int LightIndex, int property, int a, int b, int c) 
--  Property 0=(general) a=brightness (0-100%) b=cutoffdistance (0=infinite) c=light on/off (1=on, 0=ff) --
--  Property 1=(ambient color); Property 2=(diffuse color); Property 3=(specular color) where a=RED, b=GREEN, c=BLUE color values (-2.1 to 2.1 billion)--
* SetLight int LightIndex, int property, int a, int b, int c 
* MoveLight int LightIndex, int x, int y, int z --Shift light to position or direction (x,y,z)
-- PARTICLE FUNCTIONS --
* SetParticleProp int ObjectID, int Prop, any Value -- Sets a specific property of a particle system (negavtive prop RETURN the current value of the property)
* SetParticleType int ObjectID, int Type --Set Type of Particle System (type: 0=custom, 1=smoke, 2=fire, 3=frost, 4=exhaust, 5=sparks) 
* SetParticleSystem int ObjectID, int SpriteID, int time, int width, int height, int loop, int mass, int growthtime, int lifetime, int birthrate, int sizestart, int sizeend, int alphastart, int alphaend --Set Particle System Properties of Object 'ObjectID' 
* SetParticleRandomness *
-- Preferred Particle randomness parameters: int ObjectID, int x, int y, int z, int rotx, int roty, int rotz, int growthtime, int lifetime, int birthrate, int sizestart, int sizeend, int alphastart, int alphaend, float DirectionX, float DirectionY, float DirectionZ --Set Particle System Randomness of Object 'ObjectID' 
-- FOG FUNCTIONS --
* SetFog int n --Turns fog on (n=1) or off (n=0); Should be called before InitGroove to initialize fog for world
* SetFogColor int r, int g, int b --Sets the fog color, which is an RGB color made up of red, green and blue values betweens 0 and 255
* SetFogDepth int Start, int End --sets the start and end values of fog coverage radius inside the viewport (end=0, sets default values)
-- COLLISION DETECTION SETUP--
* SetCollisionAlphaThreshold int AlphaValue -- Sets global threshhold for passing through alpha pixels less than AlphaValue (0-255) 
* SetCollisionFilter int CollisionGroupFilter -- Sets global filter for determining which groups are used in collision detecion commands (0=all groups, -1=no groups)
* SetCollisionPrecision int CenterCollisions, int LeftRightCollisions, int TopBottomCollisions, int CornerCollisions, int InsideCollisions, int LongerCollisions, int VertexCollisions -- Sets the precision of the collision detection engine (returns bit list of current collision detection precision properties)
-- COLLISION DETECTION COMMANDS --
* AutoCollide int ObjectID, any TargetX, any TargetY, any TargetZ, any CollideRadius --Automatic Object collision when ObjectID is moved within distance 'CollideRadius' of point (TargetX, TargetY, TargetZ); Also returns TRUE if a collision has occured 
-- Returns collision info in globals: CollideX, CollideY, CollideZ, CollideObject, CollidePoly, CollideTexture --
* CollideTerrain int ObjectId, int Drop -- Finds nearest terrain height for object ObjectID and drops it (if Drop=1) 
* CollideVector any x, any y, any z, any VectorX,  any VectorY, any VectorZ -- Test collision in world from point (x,y,z) using vectors (X,Y,Z)
* CollidePoint any x, any y, any z, any x2,  any y2, any z2 -- Test collision in world from point (x,y,z) to point (x2,y2,z2); returns collided objectid
* GetCollide -- Dets global collision variables for last operation: collidex,collidey,collidez,collideobject,collidepoly,collidetexture,collideanglex,collideangley,collideanglez,collidenormalx,collidenormaly,collidenormalz,collidepixelx,collidepixely,collidepixelr,collidepixelg,collidepixelb,collidepixela
* GetCollideInfo -- Returns property list of collision variables for the last operation
--OBJECT PICKING --
* PickObject int x, int y -- Returns object located at 2d coordinates point(x,y)
* PickPolygon int x, int y -- Returns polygon located at 2d coordinates point(x,y)
* PickTexture int x, int y -- Returns texture located at 2d coordinates point(x,y)
-- 3D CURSOR FUNCTIONS --
* MouseDragObject int ObjectID -- Drag object 'ObjectID' with cursor (function must be called continously)
* MouseTurnObject int ObjectID -- Rotate object 'ObjectID' with cursor (function must be called continously)
* MouseOverObject --Returns ObjectID of object under cursor
* MouseOverPolygon --Returns index of polygon under cursor
* MouseOverTexture --Returns index of texture under cursor
-- OVERLAY FUNCTIONS --
* AddOverlay int channel, int Spriteid, int x, int y -- Adds bitmap overlay on top of rendering window (or below if channel<0) and returns OverlayID
* SetOverlaySprite int Overlayid, int Spriteid -- Sets the spriteID of overlay 'Overlayid' to value 'spriteid'
* SetOverlayRegPoint int Overlayid, int x, int y -- Sets the registration point of overlay 'Overlayid' to 0point (x,y) relative to the top left corner of the overlay's sprite
* SetOverlaySize int Overlayid, int width, int height -- Sets the width and height of overlay 'Overlayid' to values 'width' and 'height'
* SetOverlayLoc int Overlayid, int x, int y -- Sets the location of overlay 'Overlayid' to viewport-relative point (x,y)
* SetOverlayRect int Overlayid, int left, int top, int right, int bottom -- Sets the drawing rectangle of overlay 'Overlayid' to viewport-relative rect (left,top,right,bottom)
* SetOverlayRotation int Overlayid, any AngleDegrees -- Sets the rotation angle of overlay 'Overlayid' to angle 'AngleDegrees'
* SetOverlayLocz int Overlayid, int z --  Sets the channel and depth sort value of overlay 'Overlayid' to value 'z'
* SetOverlayVisible int Overlayid, int visible -- Sets the visibility of overlay 'Overlayid' to value 'visible'
* SetOverlayBlend int Overlayid, any blend --Sets the blend value of overlay 'Overlayid' to percent value 'blend'
* SetOverlayBrightness int Overlayid, any brightness --Sets the brightness value of overlay 'Overlayid' to percent value 'brightness'
* RestoreOverlay int Overlayid, int autocenter -- Restores the original demensions of overlay 'Overlayid' (and autocenters the overlay, if autocenter=1)
* RescaleOverlays any PercentWidth, any PercentHeight  -- Scales the overlay drawing area to the specified percentages of the original Width and Height
* ClearOverlays  -- Removes and disposes of all overlays in the rendering area
-- OVERLAY PROPERTY FUNCTIONS --
* GetOverlay int OverlayID --Rerturns property value for overlay 'OverlayID' in global variables: OverlayChannel,OverlayActive,OverlaySprite,OverlayLocY,OverlayLocX,OverlayWidth,OverlayHeight,OverlayRegx,OverlayRegy,OverlayVisible,OverlayRotation,OverlayBlend,OverlayBrightness
* GetOverlayInfo int OverlayID --Returns property values for overlay 'OverlayID' in a properyly list
* SetOverlayInfo int OverlayID, int OverlayData --Sets the property values for overlay 'OverlayID' to those in property list 'OverlayData'
-- OVERLAY CURSOR FUNCTIONS --
* SetGrooveCursor int Spriteid -- Sets custom Groove curser to sprite 'spriteid'
* MouseOverLayer  -- Returns the OverlayID currently under the cursor
* PickOverlay int x, int y, any alphathreshhold -- Returns the  OverlayID currently below rendering window coordinates (x,y)
* GetObject2Drect int ObjectID -- Returns bounding 2d rectangle of object 'ObjectID' (relative to the top left of the rendering window) 
* GetObject2Dpoint int ObjectID -- Returns 2d point location of object 'ObjectID' (relative to the top left of the rendering window)  
-- POLYGON FUNCTIONS --
* deletepolygon int ObjectID, int PolygonIndex --Deletes Polygon 'PolygonIndex' in object 'ObjectID'
* flippolygon int ObjectID, int PolygonIndex --Inverts Normal (flips) Polygon 'PolygonIndex' in object 'ObjectID'
* mergepolygons int ObjectID, int PolygonIndex1, int PolygonIndex2 --Deletes Polygon 'PolygonIndex' in object 'ObjectID'
* rotatepolygontexture int ObjectID, int PolygonIndex, any NewAngle --Rotates texture of Polygon 'PolygonIndex' in object 'ObjectID' to angle 'NewAngle'
* setpolygontexture int ObjectID, int PolygonIndex, int TextureID --Sets texture of Polygon 'PolygonIndex' in object 'ObjectID' to texture 'TextureID'
* setpolygonmaterial int ObjectID, int PolygonIndex, int MaterialID --Sets material of Polygon 'PolygonIndex' in object 'ObjectID' to material 'MaterialID'
* getpolygon int ObjectID, int PolygonIndex, int PropID --Gets proprties fro Polygon 'PolygonIndex' in object 'ObjectID'
							 --PropID: 0=type, 1=texture, 2=material, 3=number of vertices in polygon
-- UV MAPPING FUNCTIONS --
* getuvmap int ObjectID, int PolygonIndex, int VertexIndex, int UVselect --Returns U (if UVselect=1) or V (if UVselect=2) 
* setuvmap  int ObjectID, int PolygonIndex, int VertexIndex, int Uvalue, int Vvalue --Sets U and V coordinates of Vertex 'VertexIndex' in Polygon 'PolygonIndex' in object 'ObjectID'
-- VERTEX FUNCTIONS --
* GetPolyVertexIndex int ObjectID, int PolyID, int LocalPolyVertexNum -- Returns a global vertex index in Object 'ObjectID's vertex number based on the local index 'PolyVertexNum' in Polygon number 'PolyID' (vertexindex=0 returns the number of vertices in the polygon)
* GetObjectVertex int ObjectID, int VertexIndex --Gets property for vertex 'VertexIndex' in object 'ObjectID'
* SetObjectVertex int ObjectID, int VertexIndex, any  x, any y, any z --Moves vertex 'VertexIndex' in object 'ObjectID' to position (x,y,z) relative to center of shape
 -- 3D WORLD Utilities --
* GetCurrentWorld -- Returns the index of the current World being used and rendered
* SetCurrentWorld int WorldIndex -- Sets the current World that is used and rendered into
* Project2DPoint any X, any Y, any Z -- Returns a 2D point representing the projected position of 3D point (X,Y,Z) in sreen space
* ProjectObjectPosition int ObjectID, any framecount -- Projects an object's position based on current directional and angular velocities and acceleration
* LineOfSight int ObjectID, int TargetID, any framecount --Returns line of sight info for object 'ObjectID' returns list [angle x to object, angle y to object, collideobject, dist to target, dist to collideobject, dx to new object, dy to new object]
* FindNearestObject int ObjectID, any TheshholdDistance, any TheshholdAngle, int GroupFilter --returns list of nearest obects within threshold distance and angle (groupfilter used if >0; returns closest object if distance=0)
* VectorToAngleX any X, any Y, any Z -- Returns x (horizontal) angle of Vector(X,Y,Z)
* VectorToAngleY any X, any Y, any Z -- Returns y (vertical) angle of Vector(X,Y,Z)
* VectorToAngle int ObjectID -- Sets orientation of object 'ObjectID' based on its vector values
* AngleToVector int ObjectID -- Sets vector values of object 'ObjectID' based on its orientation
* QuaternionToAngle any Angle, any X, any Y, and Z -- Returns angles in list [rotx,roty,rotz] from quarternian [Angle,X,Y,Z]
* ObjectDistance int ObjectID1, int ObjectID2 -- Returns distance between ObjectID1 and ObjectID2 (returns ID of nearest object if ObjectID1=ObjectID2; projects position of ObjectID over framecoiunt(ObjectID2) if ObjectID1<0)
* PointDistance any x, any y, any z, any x2,  any y2, any z2 -- Returns distance from point (x,y,z) to point (x2,y2,z2)
* GetClippingPlane -- Returns the Clipping Plane distance 
* SetClippingPlane int n -- Sets Clipping Plane distance to value 'n'
* SetWorldBackground  int ObjectID, int TextureID -- Sets object 'ObjectID' as the world's background (if ObjectID>0) and optionally applies texture 'TextureID' (if TextureID>0)
* GetWorldColor -- Returns the world's background color as an RGBA value (red, green, blue and alpha)
* SetWorldColor  int red, int green, int blue, int alpha -- Sets world's background color to RGBA values (red, green, blue and alpha)
* SetWorldPassword string password -- sets the password to use when opening or saving an encrypted GRV file
* ObjectCount -- Returns the number of objects in all worlds
* PolyCount -- Returns the number of polygons in the world
* RenderPolyCount -- Returns the number of rendered polygons in the world
* GetFPS  *-- Returns the current frames per second
-- ASSET FUNCTIONS --
-- Asset Library Strings: ('texture', 'sprite', 'shape', 'material') --
* AssetCount string assetlib -- Returns the number of asset in library 'assetlib'
* AssetName string assetlib, int assetID -- Returns the name of an asset from its ID number and lib
* AssetID string assetlib, string assetname -- Returns the ID number of an asset from its name and lib
* TextureID string name -- Returns the asset ID number of a texture from its name
* SpriteID string name -- Returns the asset ID number of a sprite from its name
* ShapeID string name -- Returns the asset ID number of a shape from its name
* MaterialID string name -- Returns the asset ID number of a material from its name
* SpriteIDtoTextureID int SpriteID -- Returns the Texture ID of a sprite bitmap
* Force8BitTextures int n --Force JPG textures to be converted to 8-bit color when loaded if n=1 (dithers texture if n=2)
* AutoScaleTextures int PercentWidth, int PercentHeight --Automatically re-scale all subsequently loaded textures by percentages (0-100) PercentWidth and PercentHeight
-- WORLD OBJECT COMMANDS --
* FreezeWorld -- Optimize static geometry. Called after adding static shapes to world 
* DeleteAllObjects -- Remove all objects from a scene 
* ClearWorld -- Remove all objects and clear geometry, textures and sprite data from memory
-- FILE LOADING COMMANDS --
* OpenWorld string filename --Open a GRV world file and ready its contents for loading
* LoadScene string filename --Open a scene file and load its contents
* DefineMaterials string MaterialDefinitionsText --load material definitions (as ASCII text string, Max: 32 Kb) directlty into engine
* LoadMaterials string filename --load material definitions file into engine
* LoadShapeFolder string foldername --load Model folder into engine
* LoadTextureFolder string foldername --load Texture folder into engine
* LoadSpriteFolder string foldername --load Sprite folder into engine
* LoadPathFolder string foldername --load Path folder into engine
* LoadTerrain string heightfile, string texturefile --create terrain from a grayscale heightmap and a texture map
* LoadShape string filename --load single Model file into engine
* LoadTexture string filename --load single Texture file into engine
* LoadSprite string filename --load single Sprite file into engine
* LoadPath any PathData --load path data into engine from List...returns pathID
* ImportModel string filename --Import DXF,3DS, LWO, Quckdraw3D or CAD file into engine
* CloseWorld --Close the current world file and release all associated memory
* AccessWorld --Links a new GRV file to the current world
* ReleaseWorld --Unlinks the current GRV file from all asset loading commands
* SetWorldFolder string FolderName--Sets the current working directory of the GRV file
* GetWorldFileName int FileIndex --Returns the name of the file at index 'FileIndex' in the GRV's current directory
* GetWorldFileIndex string FileName --Returns the index of  file 'FileName' in the GRV's current directory
-- FILE SAVING COMMANDS --
* SaveScene string filename --save a scene file to disk
* SaveObject int ObjectID, string Filename --save an object in file 'Filename'
-- GRV FILE CREATION --
* InitGRVfile string password --Creates empty GRV file with optional password
* AddFolderToGRVfile string folderpath, string savedfoldername --Add folder to GRV file created with InitGRVfile(filename)
* SaveGRVfile string filename  --Saves GRV file 'filename'; called after 'InitWorld' and 'AddFolderToWorld'; password optional
-- GROOVE BITMAP UTILITIES --
* Add3DPixel int TextureID, int X, int Y, int Z, int Color --Add 3D particle at coordinates (x,y,z) to texture 'TextureID'
* GetPixelValue int TextureID, int X, int Y --Returns the color value of the specified pixel at location (x,y)
* SetPixelValue int TextureID, int X, int Y, int Color --Sets the color value of the specified pixel at location (x,y)
* GetPalette int TextureID, int PaletteIndex --Returns color value of the specified Palette index in Bitmap 'TextureID'
* SetPalette int TextureID, int PaletteIndex, int Red, int Green, int Blue --Sets the color value of the specified Palette index in Bitmap 'TextureID' to RGB color (red, green, blue)
* GetRGBPixel int TextureID, int X, int Y --Returns the RGB color value of the specified pixel at location (x,y)
* SetRGBPixel int TextureID, int X, int Y, int Red, int Green, int Blue --Sets the RGB color value (red, green, blue) of the specified pixel at location (x,y)
* SetRGBLevels int TextureID, int RedPercent, int GreenPercent, int BluePercent --Sets the intensity level of each color component (red, green and blue) of a bitmap
* RGBtoHSB int Red, int Green, int Blue --Returns the Hue, Saturation and Brightness values of a specified RGB color with components (red,green and blue)
-- GROOVE MEMORY UTILITIES --
* GetUsedMem --Returns total amount of memory (in bytes) used by Groove
* GetMemAddress string MediaType, int AssetID --Returns the memory address of a Groove Media Asset (types: 'texture','sprite','shape','material','object','screen'
* ReadRAMbyte int MemAddress --Returns the Byte value stored in RAM address 'MemAddress'
* WriteRAMbyte int MemAddress, int ByteValue --Sets the byte value stored in RAM address 'MemAddress' to 'ByteValue'
-- GROOVE BIT MANIPULATION UTILITIES --
* BitShift int Value, int ShiftBytes --Shifts integer 'Value' by 'ShiftBits' places
-- GROOVE ENCRYPTION UTILITIES --
* Encrypt string data, String Key --Returns encrypted text 'data' using password string 'key'
* Decrypt string data, String Key --Returns decrypted text 'data' using password string 'key'
-- GROOVE TEXT UTILITIES --
* FindText string text, String findstring --returns the location of the first character of string 'findstring' in string 'text'
-- GROOVE OS UTILITIES --
* SetWorkingDir string pathname --Set the current working directory to 'pathname'
* GetWorkingDir --Returns the current working directory
* GetFileSize string FileName --Returns the number of bytes in file 'FileName'
* ReadFile string FileName --Returns string of text data in 'FileName'
* SaveFile string Data, string FileName --Saves string 'Data' inside file 'FileName'
* SaveData string Data, int DataLength, string FileName --Saves byte stream 'Data' inside file 'FileName'
* CopyFile string source, string destination --Copy file 'source' to file(+path) 'destination'
* MergeFile string sourcefile1, string sourcefile2, string destination --Merges files 'sourcefile1' and 'sourcefile2' into file(+path) 'destination'
* ExtractFile string source, int ChunkStart, int ChunkSize, string destination --Extract file 'destination' from file 'source' using data starting at 'ChunkStart'
* CreateFolder string FolderName --Creates new folder 'FolderName' inside current directory
* YesNoAlert string Message --Opens alert box with 'yes' (returns 1), 'no' (returns 0) and 'cancel' (returns 2) buttons
* GetKeyDown string n --Returns true if 'n'=last key pressed
* AppLock int n --Disables system reboot, reset and quit keys while application is running (on: n=1; off: n=0)
* GetGroovePath string file --returns the pathname for a Groove file
* InstallGroove string GooveModule, string pathname -- Loads Groove Module
-- MOUSE COMMANDS --
* MouseWrap int n -- forces mouse to wrap around edges of the screen if n=1
* MoveCursor int X, int Y -- Moves the cursor to global screen coordinates (X,Y)
* MouseX -- Returns horizontal mouse position in global screen coordinates
* MouseY -- Returns vertical mouse position in global screen coordinates
--MEDIA COMMANDS --
* XGCI any Param, any Value -- GCI-2 Transfer media command (from Serial connection, xGCI arcarde hardware controls, etc.) 
* save3DMedia any srcCMem, string pathname -- Save media to pathname
* read3DMedia any dstCMem, string pathname -- Read media from pathname
--TIMELINE COMMANDS --
* Newspan int channel, int startframe, int endframe, int keyframecount --creates new overlay timeline span (from startframe to endframe with 'keyframecount' keyframes) and returns 'spanid'
* SetSpanKeyFrame int spanid, int keyframenum, int prop, any data --set data of keyframe 'keyframenum' of span 'spanid'
* GoFrame any Frame --Go To frame number 'FRAME' in timeline
--ENGINE PROPERTIES --
-- PrefIDnumbers: 1=maxtextures,2=maxsurfaces,3=maxshapes,4=maxobjects,5=maxmaterials,6=maxworlds,7=maxshapepolys,8=maxshapedots,9=maxlights,11=maxpolys,12=moxdots,15=maxpolydots
* SetGroovePref int prefIDnumber, int prefvalue -- Set 3D Groove Porperty 'prefIDnumber' with value 'prefvalue'
* SetGrooveLog string LogFileName, int MaxLogFileSize -- Logs debug information in file 'LogFileName' (if maxfilesize=0 then log is replaced every session)
* SetGrooveAlert int n -- Turns Groove alert messages on (if n=1) or off (if n=0) '
* EditShape string texturefolder, string filename -- Load model in 3D Editor
* GrooveVersion -- Returns 3D Groove Engine version number